home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / OS2 / AV.ARJ / AV.DOC < prev    next >
Text File  |  1992-07-11  |  8KB  |  184 lines
  1.  
  2.                         AV (Archive Viewer)
  3.                    Copyright (c) 1992 by M. Kimes
  4.                         All rights reserved
  5.  
  6.  
  7.  
  8. AV is a simple archive viewing PM utility for OS/2.  It uses a plain
  9. text configuration file (ARCHIVER.BB2) to get information about how
  10. different archives look and how their corresponding archivers work. This
  11. file is included in the AV archive and is easy to modify to add other
  12. archivers using a text editor.  As supplied, LH/2, PKZIP, ZOO, ARJ
  13. (UNARJ) and ARC are configured for you.  AV requires the OS/2 archivers
  14. to be present (on your PATH, preferably) to work.
  15.  
  16. To use AV, copy ARCHIVER.BB2 and AV.EXE somewhere on your PATH (type SET
  17. at a CMD.EXE command prompt if you don't know what your PATH is).  After
  18. that, typing AV at a command line prompt (or reasonable OS/2 facsimile)
  19. will bring up AV.  You can optionally follow that with a path or
  20. filename.  Examples:
  21.  
  22.   Start AV in current directory:
  23.     AV
  24.   Start AV on drive D: in directory \ARCS:
  25.     AV D:\ARCS\
  26.   Start AV on drive E: in directory \ADIR looking at ANARC.ARC:
  27.     AV E:\ARCS\ANARC.ARC
  28.  
  29. AV operates by presenting you with a few different dialogue boxes in
  30. which you can pick things to look at or do.  The dialogue boxes pop up
  31. under your mouse cursor.  Trust me, everything's pretty obvious.  But
  32. here's a breakdown because you don't trust me (sniff):
  33.  
  34.  
  35. Open file dialogue box:
  36. ======================
  37.  
  38.     Filename:       You can enter the name of a file directly here.  You
  39.                     can also enter a drive or directory to switch into
  40.                     directly.
  41.     Archives Only:  As for the configuration dialogue box option (see
  42.                     below).
  43.     Filemask box:   You can change the filemask here, as in the
  44.                     configuration dialogue box (see below).
  45.     Drives:         Listbox containing valid drives.  Pick one.
  46.     Directories:    Listbox containing accessible directories.  Pick
  47.                     one.
  48.     Files:          Listbox containing files.  Pick one.
  49.     Okay:           Loads currently selected file.  Beeps if there's no
  50.                     currently selected file.
  51.     Config:         Invokes configuration dialogue box.
  52.     Help:           Brief help screen for open file dialogue box.
  53.     Exit:           Outtahere, sayonara, adios.  Back to your previously
  54.                     interrupted whatever.
  55.     Del:            Delete highlighted file.
  56.  
  57.  
  58. Archive contents dialogue box:
  59. =============================
  60.  
  61.     View:   Views the highlighted file.  If more than one file is
  62.             highlighted, views the last one.
  63.     Edit:   Edits the highlighted file as for View.  You can select
  64.             the Refr(esh) button after saving the editted file to
  65.             put the new copy back into the archive.
  66.     Extr:   Extract highlighted files to the extraction directory.
  67.     Exec:   Execute the highlighted file after extracting it into the
  68.             working directory.  Warning:  many files require
  69.             configuration files, data files, etc. to run properly.
  70.     Del:    Delete highlighted files.
  71.     Cvt:    Convert entire archive to another type.
  72.     Cfg:    Calls up the configuration dialogue box.
  73.     +All:   Highlight all files in list box.
  74.     -All:   Unhighlight all files in list box.
  75.     Quit:   Return to open file dialogue.
  76.  
  77.  
  78. Select archiver dialogue box:
  79. ============================
  80.  
  81.     You'll only see this if you select the Cvt button in the above dialogue
  82.     box.  It's just a listbox containing archivers you have defined in
  83.     ARCHIVER.BB2.  Pick the one you want to use to rebuild the archive
  84.     on conversion.  Highlight it, then punch the Okay button to do the
  85.     conversion.  Select Cancel if you change your mind.
  86.  
  87.  
  88. Configuration dialogue box:
  89. ==========================
  90.  
  91.     Viewing/editting software settings:
  92.  
  93.     Viewer:  A text editor or "browser."  Many of these are available
  94.              from BBSes as shareware or freeware.  A couple that come
  95.              to mind are LIST and PMVIEW.
  96.     Editor:  A text editor, like E.EXE included with OS/2 or the
  97.              shareware QEdit.
  98.     Icons:   An icon viewer, like ICONEDIT.EXE from the OS/2 toolkit.
  99.     INFs:    An .INF file viewer, like VIEW.EXE that came with OS/2.
  100.     Metas:   A metafile (picture) viewer, like PICSHOW.EXE.
  101.     Bits:    A bitmap (picture) viewer, like ICONEDIT.EXE.
  102.     GIFs:    A GIF picture viewer, like PMGIF.EXE.
  103.     Packets: A Fidonet(tm) type 2 packet viewer, like PKTHDR.EXE.  If
  104.               you aren't involved in Fidonet, ignore this one.
  105.  
  106.     You can set everything (or some things) to the same piece of
  107.     software if desired for simplicity.  Hint:  if you want to run
  108.     through a .CMD file, use CMD.EXE /c <whatever>.CMD.
  109.  
  110.   Other configuration fields:
  111.  
  112.     Show archives only: Only names with extensions that "look" like
  113.                         archives will be listed (i.e. .ARC, .LZH,
  114.                         .ZIP, .PAK, .SDN, etc.) in the open file
  115.                         dialogue box.
  116.     Confirm delete:     Any time you hit a Delete button, AV will
  117.                         check with you to see if you meant it.
  118.     Confirm view:       If you select a "primary" file that doesn't
  119.                         smell like an archive, AV will ask if you
  120.                         want to view it using the Viewer you have
  121.                         configured.
  122.     Confirm convert:    If you select the Cvt (Convert) button,
  123.                         AV will ask if you are sure about it.
  124.     Use foreground:     AV can do some things "invisibly" if you
  125.                         don't check this (like extraction, conversion).
  126.     Filemask:           Only files matching this wildcarded spec
  127.                         will be considered for listing in the open
  128.                         file dialogue box.
  129.     Extract Dir:        The directory where AV will place extracted
  130.                         files.  The default is the directory from
  131.                         which you started AV.
  132.     Save as defaults:   Saves configuration defaults.  Otherwise they're
  133.                         only good for the current session.
  134.     Okay:               Back to wherever you were before you called up
  135.                         the configuration dialogue box.  New settings
  136.                         are used, and saved if Save as defaults is
  137.                         checked.
  138.     Help:               Brief help window for configuration dialogue
  139.                         box.
  140.     Cancel:             Back to wherever you were before you called up
  141.                         the configuration dialogue box.  New settings
  142.                         are not used or saved.
  143.  
  144.  
  145. Known bugs and features:
  146. =======================
  147.  
  148. AV doesn't handle filenames with spaces in them.  There's a limit of 400
  149. files/archive.  Other bugs and limits are as the 16-bit OS/2 API imposes
  150. them.
  151.  
  152.  
  153. Warranty:
  154. ========
  155.  
  156. None.
  157.  
  158.  
  159. Support:
  160. =======
  161.  
  162. Registered users may send and receive Fidonet netmail, Snail mail or
  163. call the BBS with questions and answers (although AV is so simple help
  164. should seldom be needed).  Unregistered users will get help if and as I
  165. get the time.
  166.  
  167.  
  168. Shareware:
  169. =========
  170.  
  171. If you like and use AV, send the author $15.00 to the address below.  If
  172. you'd like the source code (MSC 6.0a), send another $15.00.  The
  173. "registered" version doesn't have the opening popup, has working Move
  174. and Copy, and will probably have further enhancements by the time you
  175. register (I may not be the best programmer around, but I'm balls fast).
  176.  
  177.  
  178.  
  179. M. Kimes
  180. 542 Merrick
  181. Shreveport, LA  71104
  182. (318)222-3455 data
  183. 1:380/16.0@Fidonet
  184.